fix(react): complete UI messages across pages - #321

#!/bin/bash
set -euo pipefail

# Inspect declared Convex versions and locate existing query-key helpers.
fd -HI '^(package\.json|pnpm-lock\.yaml|yarn\.lock|package-lock\.json)$' . \
  -0 | xargs -0 -r rg -n -C2 '"convex"|convex-helpers'

rg -n -C3 'JSON\.stringify\(args\)|getFunctionName\(|usePaginatedMessages' \
  src/vercel/react/useUIMessages.ts

# Identify whether custom query arguments use Convex int64 or native bigint values.
rg -n -C2 --glob '*.{ts,tsx}' '\bv\.int64\b|\bBigInt\(|\bbigint\b' src

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- useUIMessages.ts ---'
cat -n src/vercel/react/useUIMessages.ts | sed -n '1,240p'

printf '%s\n' '--- Convex value and query-key serialization symbols ---'
rg -n -C3 --glob '!package-lock.json' --glob '!playground/package-lock.json' \
  'convexToJson|jsonToConvex|serialize|stable.*(string|hash)|stringify|bigint|Int64|FunctionReference' \
  src node_modules/convex node_modules/convex-helpers 2>/dev/null | head -n 500

printf '%s\n' '--- package exports related to serialization ---'
find node_modules/convex node_modules/convex-helpers -maxdepth 3 -type f \
  \( -name '*.d.ts' -o -name '*.js' -o -name '*.ts' \) -print 2>/dev/null |
  xargs -r rg -n 'convexToJson|jsonToConvex|serialize|bigint|stable' 2>/dev/null | head -n 300

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Convex package metadata and public exports ---'
cat node_modules/convex/package.json | sed -n '1,220p'
printf '%s\n' '--- Convex source files mentioning bigint ---'
rg -l --hidden --glob '!*.map' '\bbigint\b|BigInt' node_modules/convex node_modules/convex-helpers 2>/dev/null |
  head -n 80

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Relevant project tests and imports ---'
rg -n -C4 'usePaginatedMessages|planOldestOrderCompletion|useUIMessages' \
  --glob '*.{ts,tsx}' . --glob '!node_modules/**' --glob '!dist/**' --glob '!build/**' | head -n 500

printf '%s\n' '--- Convex type declarations and serializer candidates ---'
find node_modules/convex node_modules/convex-helpers -type f \
  \( -name '*.d.ts' -o -name '*.js' -o -name '*.cjs' \) -print 2>/dev/null |
  xargs -r rg -l 'convexToJson|jsonToConvex|bigint|BigInt|ConvexValue|Value' 2>/dev/null |
  head -n 100

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Convex value definitions and public serializer ---'
cat -n node_modules/convex/src/values/value.ts | sed -n '1,240p'
cat -n node_modules/convex/dist/cjs-types/values/index.d.ts | sed -n '1,220p'
rg -n -C8 'convexToJson|jsonToConvex|JSON\.stringify|args' \
  node_modules/convex/src/react node_modules/convex/src/browser/sync \
  node_modules/convex-helpers/src node_modules/convex-helpers/dist 2>/dev/null | head -n 500

printf '%s\n' '--- Paginated query argument identity implementation ---'
rg -n -C8 'queryKey|query.*args|JSON\.stringify|convexToJson' \
  node_modules/convex/src/react node_modules/convex-helpers/src \
  node_modules/convex/dist/esm/react node_modules/convex-helpers/dist 2>/dev/null | head -n 500

#!/bin/bash
set -euo pipefail

node --input-type=module - <<'JS'
import { convexToJson, jsonToConvex } from "convex/values";

const values = [
  ["native bigint", { value: 123n }],
  ["nested bigint", { value: { nested: [1n, "x"] } }],
  ["date", { value: new Date("2025-01-01T00:00:00.000Z") }],
  ["array buffer", { value: new Uint8Array([1, 2, 3]).buffer }],
];

for (const [name, value] of values) {
  let jsonResult;
  let jsonError;
  try {
    jsonResult = JSON.stringify(value);
  } catch (error) {
    jsonError = String(error);
  }

  let convexResult;
  let convexError;
  try {
    convexResult = convexToJson(value);
  } catch (error) {
    convexError = String(error);
  }

  console.log(JSON.stringify({
    name,
    jsonResult,
    jsonError,
    convexResult,
    convexError,
    roundTrip: convexError ? undefined : jsonToConvex(convexResult),
  }));
}
JS

#!/bin/bash
set -euo pipefail

printf '%s\n' '--- Exact Convex value union and bigint validator behavior ---'
rg -n -C12 'export (type|interface).*Value|type Value|bigint|v\.int64|int64' \
  node_modules/convex/src/values/value.ts \
  node_modules/convex/src/values/validators.ts \
  node_modules/convex/src/values/validator.ts \
  node_modules/convex/dist/cjs-types/values/*.d.ts 2>/dev/null | head -n 400

printf '%s\n' '--- Query argument serialization in installed dependencies ---'
rg -n -C10 'convexToJson|JSON\.stringify|queryKey|args' \
  node_modules/convex/dist/esm/react node_modules/convex/dist/esm/browser \
  node_modules/convex-helpers/dist node_modules/convex-helpers/src 2>/dev/null | head -n 600

#!/bin/bash
set -euo pipefail

node --input-type=module - <<'JS'
import { convexToJson } from "convex/values";

for (const value of [{ value: 1n }, { value: { nested: [1n] } }]) {
  let native;
  let nativeError;
  try {
    native = JSON.stringify(value);
  } catch (error) {
    nativeError = String(error);
  }

  let encoded;
  let encodedError;
  try {
    encoded = JSON.stringify(convexToJson(value));
  } catch (error) {
    encodedError = String(error);
  }

  console.log({ native, nativeError, encoded, encodedError });
}
JS

#!/bin/bash
set -euo pipefail

rg -n -C10 'export type Value|type Value|bigint|v\.int64|convexToJson|JSON\.stringify' \
  node_modules/convex/src/values \
  node_modules/convex/dist/cjs-types/values \
  node_modules/convex/dist/esm/values \
  node_modules/convex-helpers 2>/dev/null | head -n 500

#!/bin/bash
set -euo pipefail

node --input-type=module - <<'JS'
import { convexToJson } from "convex/values";

const cases = [
  ["bigint", { value: 1n }],
  ["nan", { value: Number.NaN }],
  ["null", { value: null }],
  ["negative zero", { value: -0 }],
  ["zero", { value: 0 }],
  ["bytes A", { value: new Uint8Array([1]).buffer }],
  ["bytes B", { value: new Uint8Array([2]).buffer }],
];

for (const [name, args] of cases) {
  let native;
  let nativeError;
  try {
    native = JSON.stringify(args);
  } catch (error) {
    nativeError = String(error);
  }

  const convex = JSON.stringify(convexToJson(args));
  console.log(name, { native, nativeError, convex });
}
JS

#!/bin/bash
set -euo pipefail

node --input-type=module - <<'JS'
import { convexToJson } from "convex/values";

const cases = [
  ["bigint", { value: 1n }],
  ["nan", { value: Number.NaN }],
  ["null", { value: null }],
  ["negative zero", { value: -0 }],
  ["zero", { value: 0 }],
  ["bytes A", { value: new Uint8Array([1]).buffer }],
  ["bytes B", { value: new Uint8Array([2]).buffer }],
];

for (const [name, args] of cases) {
  let native;
  let nativeError;
  try {
    native = JSON.stringify(args);
  } catch (error) {
    nativeError = String(error);
  }

  console.log(name, {
    native,
    nativeError,
    convex: JSON.stringify(convexToJson(args)),
  });
}
JS